home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / comm / cnet / cnet_toolkit.lha / !READ_ME_FIRST! next >
Text File  |  1997-04-05  |  6KB  |  122 lines
  1. ============================================================================
  2.                 CNet Amiga TOOLKIT, v3.00 IMPORTANT INFO!
  3. ============================================================================
  4.  
  5.     The "CNet_BBSTEXT.Lines!" file contains numerous lines that are LONGER
  6. than 255 characters.
  7.  
  8.     For this reason, do NOT attempt to load this file into a text editor
  9. that does NOT support line lengths longer than this max. This includes the
  10. following text editors: ED, MEMACS(EMACS), AZ.
  11.  
  12.     CED, EDGE and GoldEdit are three editors I've found that WILL work with
  13. line lengths greater than 255 characters, so I suggest using one of these 
  14. editors if you'll be editing, copying, etc. line(s) from this file.
  15.  
  16.     ALL OTHER FILES located within this archive are SAFE to be loaded and/or
  17. edited using ANY text editor.
  18.  
  19.     The "Routines/" directory includes ONLY the actual routine talked about
  20. in the "CNet_ToolKit.REXX!" file. They are included separately, because some
  21. text editors allow you to INCLUDE/PASTE text from external files. This can
  22. save you some time when wanting to add one or more of the included routines
  23. into a program of your own.
  24.  
  25.     Some text editors that SUPPORT the INCLUDE/PASTE function are MEMACS,
  26. AZ, CED and EDGE. I believe the GoldEdit program will also support it, but
  27. I neglected to test it before purging it from my system. Here's how to do it
  28. with the four editors I WAS able to test:
  29.  
  30.     MEMACS : Project Menu/Insert-file       (Key=^X^I), where ^ is CONTROL.
  31.  
  32.        AZ  : Edit Menu/Copy From File...    (No Key)
  33.              followed by Edit Menu/Paste    (Key=AMIGA-P)
  34.  
  35.        CED : Project Menu/Include File...   (Key=AMIGA-O)
  36.  
  37.       EDGE : Project Menu/Include...        (Key=AMIGA-O is default)
  38.  
  39.     I was playing with CED's ARexx Interface and came up with a little script
  40. you may want to use to help automate the include job somewhat. Included in
  41. the archive is the file "IncRoutines.ced". Load this small file into CED and
  42. modify the path following 'getfilename' to reflect the location you stored
  43. the "/Routines/" directory. The "PARSE_SORT" will be the DEFAULT routine that
  44. will be highlighted when you're presented with the file requestor. You can
  45. change it to another routine if there's one you user more often. Once you've
  46. changed it, save the file and remember it's location.
  47.  
  48.     To add this functionality into CED (v3.5 is what I'm using), you can do
  49. one of two things:
  50.  
  51. 1. Call it from an unqualified Function Key by selecting DOS/ARexx Interface
  52.    from the Special menu, then selecting Install DOS/ARexx command... You
  53.    then specify a number from 1 thru 10 that corresponds to the Function Key
  54.    of the same name. Press ENTER or click OK, then type the following when it
  55.    prompts for Enter DOS/ARexx command:
  56.  
  57.                 <path>IncRoutines.ced
  58.  
  59.    Where <path> is the location you opted to store the "IncRoutines.ced" file.
  60.    Complete the process by selecting Special >> DOS/ARexx Interface >> Save
  61.    DOS/ARexx commands... (A file titled "RexxCommands" will be created in
  62.    your S: directory).
  63.  
  64. <or>
  65.  
  66. 2. Define a keyboard key macro that calls the script. I discovered that the
  67.    RAMIGA - I combination is NOT used by default, so it would come in real
  68.    handy for our "Include routine" function. To create the macro, press
  69.    RAMIGA - m to define a keyboard macro. In the title bar, you'll see the
  70.    text "Choose key to define macro for". Press RAMIGA - i and the title bar
  71.    will then say "Put in macro definition". Do the following:
  72.  
  73.         - With your mouse, open the SPECIAL Menu, then open the
  74.           DOS/ARexx Interface submenu.
  75.  
  76.         - Choose the "Send DOS/ARexx command..." option in the
  77.           submenu, then type the following:
  78.  
  79.                 <path>IncRoutines.ced
  80.  
  81.           Where <path> is the location you opted to store the included
  82.           "IncRoutines.ced" file.
  83.  
  84.         - Press ENTER or click OK. You should then be asked if you wish the
  85.           contents of the requestor to be used in the Macro. Click YES.
  86.  
  87.         - Complete the macro by pressing RAMIGA - m one last time.
  88.  
  89.     Now SAVE your macro using "E"nvironment >> Macro definitions >>
  90. Save definitions... (A file titled "cedmacros" will be created in your S:
  91. directory).
  92.  
  93.     To use the above functionality, simply do the following:
  94.  
  95.         - Place your cursor where you'd like the CNet ToolKit Routine to be
  96.           placed within your code, then invoke the function by pressing the
  97.           defined function key, or by pressing RAMIGA - i.
  98.  
  99.         - You should be presented with a file requestor asking for the Rexx
  100.           Routine to include. Select the routine, then press ENTER or click
  101.           the OK button. (By pressing CANCEL, you can ABORT the process!)
  102.  
  103.         - The requested routine will be inserted directly into your code.
  104.  
  105.     Another NEW entity to the CNet Amiga ToolKit is the "RexxToolKit.guide"
  106. file. This guide file is basically the same as the "CNetToolKit.REXX!" file,
  107. except the actual routines and examples have been stripped out. What's left
  108. is the FORMAT and USAGE templates for ALL included ARexx routines. I would
  109. highly suggest adding a launch command for this file in Tool Manager or in
  110. another task launch type program. You could even assign a hot key for it,
  111. just like you did with the CED macro above. (Perhaps RAMIGA - SHIFT - I)
  112. You'll then have two QUICK ways to get the routine INTO your file, as well
  113. as having the ability to QUICKLY refresh yourself as to the arguments or
  114. proper formatting of a given routine.
  115.  
  116.     I hope you enjoy the files included within this package and that you'll
  117. drop a line to one of the author(s) and/or contributor(s) letting them know
  118. if and when you decide to use one or more of their ideas in works of your
  119. own design!
  120.                                                                   - Dotoran
  121. ============================================================================
  122.